home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / utilit~1 / flut39st.zoo / fileutils-3.9 / man / cp.1 < prev    next >
Encoding:
Text File  |  1994-03-26  |  5.5 KB  |  193 lines
  1.  
  2.  
  3.  
  4. CP(1L)                               CP(1L)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        cp - copy files
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        c✓cp✓p [options] source dest
  12.        c✓cp✓p [options] source... directory
  13.        Options:
  14.        [-abdfilprsuvxPR]    [-S       backup-suffix]    [-V    {num-
  15.        bered,existing,simple}]     [--backup]    [--no-dereference]
  16.        [--force] [--interactive] [--one-file-system] [--preserve]
  17.        [--recursive]  [--update]  [--verbose]    [--suffix=backup-
  18.        suffix]       [--version-control={numbered,existing,simple}]
  19.        [--archive]   [--parents]    [--link]    [--symbolic-link]
  20.        [--help]    [--version]
  21.  
  22. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  23.        This  manual page documents the GNU version of c✓cp✓p.  If the
  24.        last argument names an existing directory, c✓cp✓p copies  each
  25.        other  given  file  into    a file with the    same name in that
  26.        directory.  Otherwise, if only two  files  are  given,  it
  27.        copies  the  first onto the second.  It is an error if the
  28.        last argument is    not a directory    and more than  two  files
  29.        are given.  By default, it does not copy    directories.
  30.  
  31.    O✓OP✓PT✓TI✓IO✓ON✓NS✓S
  32.        _✓-_✓a_✓, _✓-_✓-_✓a_✓r_✓c_✓h_✓i_✓v_✓e
  33.           Preserve    as  much as possible of    the structure and
  34.           attributes of the    original files in the copy.   The
  35.           same as _✓-_✓d_✓p_✓R.
  36.  
  37.        _✓-_✓b_✓, _✓-_✓-_✓b_✓a_✓c_✓k_✓u_✓p
  38.           Make  backups  of     files that are    about to be over-
  39.           written or removed.
  40.  
  41.        _✓-_✓d_✓, _✓-_✓-_✓n_✓o_✓-_✓d_✓e_✓r_✓e_✓f_✓e_✓r_✓e_✓n_✓c_✓e
  42.           Copy symbolic links as symbolic links  rather  than
  43.           copying  the files that they point to, and preserve
  44.           hard link    relationships between source files in the
  45.           copies.
  46.  
  47.        _✓-_✓f_✓, _✓-_✓-_✓f_✓o_✓r_✓c_✓e
  48.           Remove existing destination files.
  49.  
  50.        _✓-_✓i_✓, _✓-_✓-_✓i_✓n_✓t_✓e_✓r_✓a_✓c_✓t_✓i_✓v_✓e
  51.           Prompt whether to    overwrite existing regular desti-
  52.           nation files.
  53.  
  54.        _✓-_✓l_✓, _✓-_✓-_✓l_✓i_✓n_✓k
  55.           Make  hard  links     instead  of   copies    of   non-
  56.           directories.
  57.  
  58.        _✓-_✓P_✓, _✓-_✓-_✓p_✓a_✓r_✓e_✓n_✓t_✓s
  59.           Form the name of each destination    file by    appending
  60.           to the target directory a    slash and  the    specified
  61.  
  62.  
  63.  
  64. FSF            GNU File Utilities            1
  65.  
  66.  
  67.  
  68. CP(1L)                               CP(1L)
  69.  
  70.  
  71.           name  of    the source file.  The last argument given
  72.           to c✓cp✓p must be the    name of     an  existing  directory.
  73.           For example, the command `cp --parents a/b/c exist-
  74.           ing_dir'    copies     the   file   _✓a_✓/_✓b_✓/_✓c   to   _✓e_✓x_✓i_✓s_✓t_✓-
  75.           _✓i_✓n_✓g_✓__✓d_✓i_✓r_✓/_✓a_✓/_✓b_✓/_✓c_✓,  creating    any  missing intermediate
  76.           directories.
  77.  
  78.        _✓-_✓p_✓, _✓-_✓-_✓p_✓r_✓e_✓s_✓e_✓r_✓v_✓e
  79.           Preserve the original files' owner, group,  permis-
  80.           sions, and timestamps.
  81.  
  82.        _✓-_✓r     Copy  directories     recursively,  copying    all  non-
  83.           directories as if    they were regular files.
  84.  
  85.        _✓-_✓s_✓, _✓-_✓-_✓s_✓y_✓m_✓b_✓o_✓l_✓i_✓c_✓-_✓l_✓i_✓n_✓k
  86.           Make symbolic  links  instead  of     copies     of  non-
  87.           directories.  All    source filenames must be absolute
  88.           (starting    with `/') unless  the  destination  files
  89.           are in the current directory.  This option produces
  90.           an error message on systems  that     do  not  support
  91.           symbolic links.
  92.  
  93.        _✓-_✓u_✓, _✓-_✓-_✓u_✓p_✓d_✓a_✓t_✓e
  94.           Do  not  copy  a    nondirectory that has an existing
  95.           destination with the  same  or  newer  modification
  96.           time.
  97.  
  98.        _✓-_✓v_✓, _✓-_✓-_✓v_✓e_✓r_✓b_✓o_✓s_✓e
  99.           Print the    name of    each file before copying it.
  100.  
  101.        _✓-_✓x_✓, _✓-_✓-_✓o_✓n_✓e_✓-_✓f_✓i_✓l_✓e_✓-_✓s_✓y_✓s_✓t_✓e_✓m
  102.           Skip  subdirectories that    are on different filesys-
  103.           tems from    the one    that the copy started on.
  104.  
  105.        _✓-_✓R_✓, _✓-_✓-_✓r_✓e_✓c_✓u_✓r_✓s_✓i_✓v_✓e
  106.           Copy directories recursively.
  107.  
  108.        _✓-_✓-_✓h_✓e_✓l_✓p Print a usage message on standard    output    and  exit
  109.           successfully.
  110.  
  111.        _✓-_✓-_✓v_✓e_✓r_✓s_✓i_✓o_✓n
  112.           Print  version  information on standard output then
  113.           exit successfully.
  114.  
  115.        _✓-_✓S_✓, _✓-_✓-_✓s_✓u_✓f_✓f_✓i_✓x _✓b_✓a_✓c_✓k_✓u_✓p_✓-_✓s_✓u_✓f_✓f_✓i_✓x
  116.           The suffix used for making simple    backup files  can
  117.           be  set  with  the S✓SI✓IM✓MP✓PL✓LE✓E_✓_B✓BA✓AC✓CK✓KU✓UP✓P_✓_S✓SU✓UF✓FF✓FI✓IX✓X environment
  118.           variable,    which can be overridden    by  this  option.
  119.           If  neither  of those is given, the default is `~',
  120.           as it is in Emacs.
  121.  
  122.        _✓-_✓V_✓, _✓-_✓-_✓v_✓e_✓r_✓s_✓i_✓o_✓n_✓-_✓c_✓o_✓n_✓t_✓r_✓o_✓l _✓{_✓n_✓u_✓m_✓b_✓e_✓r_✓e_✓d_✓,_✓e_✓x_✓i_✓s_✓t_✓i_✓n_✓g_✓,_✓s_✓i_✓m_✓p_✓l_✓e_✓}
  123.           The type of backups made can be set with    the  V✓VE✓ER✓R-✓-
  124.           S✓SI✓IO✓ON✓N_✓_C✓CO✓ON✓NT✓TR✓RO✓OL✓L  environment     variable,  which  can be
  125.  
  126.  
  127.  
  128. FSF            GNU File Utilities            2
  129.  
  130.  
  131.  
  132. CP(1L)                               CP(1L)
  133.  
  134.  
  135.           overridden by this option.  If  V✓VE✓ER✓RS✓SI✓IO✓ON✓N_✓_C✓CO✓ON✓NT✓TR✓RO✓OL✓L  is
  136.           not  set    and this option    is not given, the default
  137.           backup type is `existing'.  The value of    the  V✓VE✓ER✓R-✓-
  138.           S✓SI✓IO✓ON✓N_✓_C✓CO✓ON✓NT✓TR✓RO✓OL✓L  environment    variable and the argument
  139.           to this option are like  the  GNU     Emacs    `version-
  140.           control'    variable;  they     also  recognize synonyms
  141.           that are more descriptive.  The  valid  values  are
  142.           (unique abbreviations are    accepted):
  143.  
  144.           `t' or `numbered'
  145.              Always make numbered backups.
  146.  
  147.           `nil' or `existing'
  148.              Make  numbered backups of files that already
  149.              have them,    simple backups of the others.
  150.  
  151.           `never' or `simple'
  152.              Always make simple    backups.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192. FSF            GNU File Utilities            3
  193.